home *** CD-ROM | disk | FTP | other *** search
/ PD ROM 1 / PD ROM Volume I - Macintosh Software from BMUG (1988).iso / Programming / Programming Tools / HFS Find. / HFS find Hints next >
Encoding:
Text File  |  1994-10-02  |  7.4 KB  |  183 lines  |  [TEXT/ttxt]

  1.              
  2.                   
  3.  
  4.  
  5.  
  6. These instructions are for HFS Find version 1.0
  7.  
  8. Introduction
  9.  
  10.     HFS Find searches an HFS volume for files.  You may limit the search to
  11.     files that have a particular name, creator, type, or modification date, or
  12.     that reside under a specific folder.
  13.  
  14. Using HFS Find
  15.  
  16.     When you open HFS Find, a window appears.  This window contains
  17.     seven boxes for entering text, eight check buttons, and two push
  18.     buttons.
  19.  
  20.     The seven text boxes are used to tell HFS Find what files you want
  21.     to search for.  Each of these is associated with a check button,
  22.     which is located to the left of the text box.  When the check button
  23.     is checked, the text box is ACTIVE, which means that HFS Find will
  24.     use the text in the box to determine what files to show.  When the
  25.     check button is not checked, the text box is INACTIVE.  HFS Find
  26.     ignores the contents of inactive text boxes.
  27.  
  28.     The top two text boxes are used to hold a file type and a file
  29.     creator.  The next two are used to hold modification dates.  The
  30.     final three are used to hold file names.
  31.  
  32.     A file will be shown if all of the following conditions are true:
  33.  
  34.         Either the "creator" box is inactive, or the file creator matches
  35.         the contents of the "creator" box.
  36.  
  37.         Either the "type" box is inactive, or the file type matches
  38.         the contents of the "type" box.
  39.  
  40.         Either the "Older than" box is inactive, or the modification date
  41.         of the file is earlier than the date in the "Older than" box.
  42.  
  43.         Either the "Newer than" box is inactive, or the modification date
  44.         of the file is later than the date in the "Newer than" box.
  45.  
  46.         Either all the "name" boxes are inactive, or the file name matches
  47.         the contents of one of the active "name" boxes.  It doesn't have
  48.         to match exactly.  See below for more information.
  49.  
  50.     The check button labeled "Search whole disk" controls where HFS Find
  51.     looks.  If the button is checked, HFS Find will search the entire
  52.     volume.  When the button is unchecked, HFS Find will only look at
  53.     files and folders under the current folder.
  54.  
  55.     You may set the current folder by pressing the "Search From" button.
  56.     You select a file in the folder you wish to start searching from.
  57.     ( There is currently no way to select a folder directly.  If the
  58.     folder you want to start searching from contains only other folders,
  59.     there is no way to restrict the search to just that folder.  Sorry. )
  60.  
  61.     Finally, to actually start a search, press the "Do Search!" button.
  62.  
  63. Results
  64.  
  65.     When HFS Find finds a file or folder that satisfies the conditions
  66.     you specified, it will present a dialog.  At the top of the dialog
  67.     will be the name of the file or directory.  Below this is the path
  68.     name.  The path will be from the root of the volume if you searched
  69.     the entire volume, and from the current folder if you didn't.
  70.  
  71.     There are four buttons in the dialog.  The "Cancel Search" button
  72.     cancels the search.  The "Continue Search" button continues the
  73.     search.
  74.  
  75.     The "Skip Folder" button does one of two things.  If the file being
  76.     shown is a folder, then "Skip Folder" causes the search to be
  77.     resumed, but to skip any files contained in that folder.  If the
  78.     file being shown is not a folder, then "Skip Folder" causes the
  79.     search to continue, but to not show any more files from the folder
  80.     that this file is in.
  81.  
  82.     The last button, "Set Standard File Folder", sets the folder that the
  83.     standard file package uses to be the folder that the file or folder
  84.     shown is contained in.  When you select OPEN or SAVE AS from the FILE
  85.     menu in most applications, this is the folder that the OPEN or
  86.     SAVE AS dialog will start in.
  87.  
  88. Stopping a Search
  89.  
  90.     Press and hold the mouse button down during a search to abort.
  91.  
  92. Matching Names
  93.  
  94.     A file name matches the contents of a name box if the file name
  95.     starts with the characters in the name box.  For example, a name
  96.     box that contains "abc" would match files "abc", "abcd", but not
  97.     "ab".
  98.  
  99.     Four characters have special meaning in a name box.  "?" matches
  100.     with any single character of the file name.  "*" matches any
  101.     number of characters from the file name ( including zero characters ).
  102.     A "$" at the end of a name box matches the end of a file name.
  103.     Finally, ":" followed by another character matches that other
  104.     character.
  105.  
  106.     Here are some examples:
  107.         "*.h$" would match all files that end with ".h".  "*.h" would
  108.         match all files that have ".h" anywhere in their name.  "a*b?c*d?$"
  109.         would match all files whose name starts with an "a", has a "b" two
  110.         characters before a "c", and somewhere after the "c", has a "d",
  111.         one more character, and then ends.  Note that it would NOT match
  112.         a file named "abdc", because the "d" can not be used to match both
  113.         "b?c" and "d?".  
  114.  
  115. Dates
  116.  
  117.     The two text boxes that accept a data accept two formats.  The first
  118.     is MONTH/DAY/YEAR, where MONTH is the month number ( 1-12 ), day is
  119.     the day number, and YEAR is the year.  If the year is less than 1900,
  120.     HFS Find will add 1900 before using it.  For example, 1/1/86 and
  121.     1/1/1986 represent the same date.
  122.  
  123.         You may instead specify the number of minutes, hours, or days before
  124.     the current date and time.  You do this be entering a minus sign,
  125.     the number of mintues, hours, or days, and an M, H, or D ( or m, h, or
  126.     d ).  For example, -12h would mean 12 hours before the time the
  127.     "Do Search!" button is pressed.  -7D would mean 7 days.
  128.  
  129. Another Way to Enter Things in the Type, Creator, and Date Boxes.
  130.  
  131.     If you press the command key and click the mouse button in one of
  132.     these boxes, you will be presented with a dialog that lets
  133.     you select a file.  The type, creator, or date will be set to
  134.     match the file you select.
  135.  
  136. An Example
  137.  
  138.     We desire to find all MacWrite files whose name starts with "Report"
  139.     or "Chapter".
  140.  
  141.     Type "macwrite" into a name box.  Make that the only active box.  We
  142.     then search the whole disk to find MacWrite.  When we find it, we
  143.     press "Set SFGetFile directory", and then "Cancel Search".
  144.  
  145.     Now we command click in the "creator" box.  We select MacWrite from
  146.     the list of files shown.  "MACA" appears in the "creator" box.
  147.  
  148.     Enter "report" in a name box, and "chapter" in another name box.
  149.     Make those name boxes active.  Also make the creator box active.
  150.     Press "Do Search".
  151.  
  152. Another Example
  153.  
  154.     We want to decide if it is time to do a backup of our hard disk.
  155.     We did our last backup 7 days ago.
  156.  
  157.     Open HFS Find.  Type "-8d" ( eight rather than seven to be safe )
  158.     into the "After" box.  Activate it by checking it's check box.
  159.  
  160.     Deactivate all the other boxes.  Make sure "Search whole disk" is
  161.     checked.
  162.  
  163.     Press search.
  164.  
  165.     You will see all files you have diddled with since your backup.
  166.  
  167. Program Limits
  168.  
  169.     Folders more than 32 levels below the folder the search starts in
  170.     will be skipped.  You will be told when HFS Find is going to have
  171.     to skip some folders.
  172.  
  173.     The path name for a file can not exceed about 1200 characters.  If
  174.     it does, the world will end.  You should hit the depth limit before
  175.     you hit this one.
  176.  
  177.     No text box should contain more than about 35 characters.
  178.  
  179.     HFS Find *seems* to work on MFS volumes also, although it was not
  180.     meant to do so.  That it does may be considered an accident.
  181.  
  182.  
  183. Pr